home *** CD-ROM | disk | FTP | other *** search
/ SGI Enlighten DSM 1.1 / SGI EnlightenDSM 1.1.iso / irix5x6x / admin.z / admin / help / C / online0521.hlp < prev    next >
Text File  |  1998-06-30  |  13KB  |  379 lines

  1.     Modify New User Template
  2.  
  3.     Enlighten supports the concept of user account templates. You can
  4.     use these templates to facilitate the creation of new user accounts.
  5.  
  6.     Each template specifies the defaults Enlighten will use when it adds
  7.     a new user to the system. If you leave a field blank when you're
  8.     adding a new user account, Enlighten will substitute the default
  9.     parameters set-up for that field.
  10.  
  11.  
  12.     Fields
  13.  
  14.     The window has the following fields:
  15.  
  16.     Template Name
  17.  
  18.     This read-only field specifies the template's name. 
  19.  
  20.     Description
  21.  
  22.     Use this field to briefly describe this template's purpose. This is
  23.     used by other commands, such as Session Preferences and Adding
  24.     Users, when you want a pop-up list of available templates displayed.
  25.  
  26.     Login Name Macro
  27.  
  28.     Use this field to specify a macro for the user name. 
  29.     See USER ACCOUNT MACROS below for a detailed explanation of how
  30.     to use macros.
  31.  
  32.     Home directory
  33.  
  34.     The Home directory field specifies where the user's start-up
  35.     directory is attached. Most systems will use /usr or /home as the
  36.     default parent directory. Each user will have their own directory
  37.     created under the default home directory, e.g. /usr/charlie.
  38.     Enlighten stores /usr as the default HOME directory unless you
  39.     change this field. If the default Home Directory is /eng, and the
  40.     login name of the new user account is fred, the name of the HOME
  41.     directory Enlighten generates would be:
  42.  
  43.         /eng/fred
  44.  
  45.     You can also use macros in this field. 
  46.     See USER ACCOUNT MACROS below for a detailed explanation of how
  47.     to use macros.
  48.  
  49.     Startup Shell
  50.  
  51.     The Shell is a program that acts as a translator between the user
  52.     and the UNIX operating system. There may be several standard shells
  53.     on a system, including the C Shell, the Bourne Shell, the Korn Shell
  54.     and the restricted Bourne, C and Korn Shells. Each shell has its own
  55.     start-up executable program as shown below.
  56.  
  57.         Bourne Shell /bin/sh
  58.  
  59.         Restricted Bourne Shell /bin/rsh
  60.  
  61.         C Shell /bin/csh
  62.  
  63.         Korn Shell /bin/ksh
  64.  
  65.         Restricted Korn Shell /bin/rksh
  66.  
  67.         Other user defined
  68.  
  69.     Enlighten uses the Bourne shell as the default shell in this field
  70.     (/bin/sh). The number of standard shells available for this field
  71.     depends on your system. Click on the arrow button to display a pick
  72.     list of available shells.
  73.  
  74.     Primary Group Name
  75.  
  76.     Every user account must be assigned to at least one User Group. The
  77.     User Group is part of the UNIX security system; each user group has
  78.     specific read, write, and execute privileges associated with every
  79.     file created on the system.
  80.  
  81.     Enter the Primary Group Name for this template. You can also click
  82.     on the arrow button for a pick list of defined User Groups and make
  83.     your selection from there. If you enter a Primary Group Name which
  84.     does not exist, Enlighten will prompt for a correct Group Name when
  85.     it tries to create the user.
  86.  
  87.     Additional Groups
  88.  
  89.     You can use this field to put the user in additional user groups.
  90.     This will effectively give the user more group privileges beyond
  91.     those set in the primary user group. Enter the names of the user
  92.     groups to which the user should also belong. If you are using
  93.     multiple entries, leave a blank between each entry.
  94.  
  95.     You can also click on the arrow button for a pick list of defined
  96.     User Groups. Select the User Groups and click on the Apply button to
  97.     import them.
  98.  
  99.     UID Range from ... to
  100.  
  101.     You can use these fields to define a UID range for the template.
  102.     This range is used if you set the next field to have a UID
  103.     automatically generated for the user.
  104.  
  105.     Automatically generate unique UID if it's missing
  106.  
  107.     Each user account created must have a UserID number. Use this toggle
  108.     to choose whether a unique UID is generated for a new user if you
  109.     don't specify one during creation of the new user account. The
  110.     default is not to (No).
  111.  
  112.     Default Password
  113.  
  114.     The password is part of the UNIX security system. Each user must
  115.     have a password. If you make the password the same as the user
  116.     login, the user can then reset the password to one of his or her own
  117.     choice. Don't use passwords such as spouse names, pet names, or
  118.     addresses, they are easy for another user to guess.
  119.  
  120.     You can also use macros in this field. 
  121.     See USER ACCOUNT MACROS below for a detailed explanation of how
  122.     to use macros.
  123.  
  124.     Note: If the entry in the password field is not long enough, an
  125.     error message will be displayed when you try to add this user
  126.     account.
  127.  
  128.     Password Expiry
  129.  
  130.     For systems that support password aging, this optional field
  131.     contains the time when the password will expire. Once a password has
  132.     expired, the system will force the user to change their password the
  133.     next time they login to the system.
  134.  
  135.     If this field is left blank, the appropriate default parameter will
  136.     be used. If no default is set in the User Add window (when you're
  137.     adding a user), password aging will be turned off for that user. 
  138.  
  139.     See TIME FORMATS below for a description of supported time formats.
  140.  
  141.     Password Life Span
  142.  
  143.     In conjunction with the previous field, this field defines the
  144.     minimum period of time which needs to elapse before the user can
  145.     change his or her password. 
  146.  
  147.     See TIME FORMATS below for a description of supported time formats.
  148.  
  149.     Note: You can change the user's password at any time by using the
  150.     Password button in the User Configuration window. 
  151.  
  152.     Minimum Password Length
  153.  
  154.     Each user account has a password associated with it. This password
  155.     is defined when the user account is created and may be changed any
  156.     time thereafter. This field accepts a numeric entry defining the
  157.     minimum length that the (new) password must be whenever the password
  158.     is created or modified. You can also use the counter buttons on the
  159.     right to increment or decrement the number shown.
  160.  
  161.     Note: If you set this value to zero, the user does not need to use a
  162.     password when logging into the system. The user will still be asked
  163.     by the system to enter a password, however. The user can then log in
  164.     by hitting the <return> key.
  165.  
  166.     Require user to have a password
  167.  
  168.     It may be necessary sometimes for a user to have no password. By
  169.     default, Enlighten forces each user to have a password. To configure
  170.     user accounts with no password, set this toggle to No.
  171.  
  172.     Mail Alias
  173.  
  174.     This field specifies the default mail alias the account will use. An
  175.     alias designates a short name as the substitute for the full
  176.     pathname for a particular user or group, e.g., laura for
  177.     laura_lombardo@desk.com.
  178.  
  179.     You can also use macros in this field. 
  180.     See USER ACCOUNT MACROS below for a detailed explanation of how
  181.     to use macros.
  182.  
  183.     Mail Lists
  184.  
  185.     This field specifies which mailing lists will be updated to include
  186.     this user account. A mail list defines a group of people under one
  187.     alias, so sending mail to that alias will distribute a copy everyone
  188.     on that list. If you are using multiple entries, leave a blank
  189.     between each entry. You can also click on the arrow button for a
  190.     pick list of defined Mail Lists and make your selection(s) from
  191.     there.
  192.  
  193.     Buttons
  194.  
  195.     The Modify New User Template window has the following buttons:
  196.  
  197.     Modify
  198.  
  199.     Once you've specified all the changes to the new user template,
  200.     click on this button to save it. Then you can access this template
  201.     when you are setting your session preferences or adding users.
  202.  
  203.     Clear Fields
  204.  
  205.     Click on this button to clear the existing choices in all fields.
  206.  
  207.     Next
  208.    
  209.     You can use the Next button to modify additional templates if 
  210.     you've selected more than one to modify from the template list.
  211.  
  212.     Cancel
  213.  
  214.     Click on this button to close the window without making any changes.
  215.  
  216.  
  217.     TIME FORMATS
  218.  
  219.     There are several fields throughout the Enlighten product where you
  220.     can specify a date/time format. For each of these fields, you can
  221.     specify the date and/or time period in two ways: absolutely or
  222.     relatively.
  223.  
  224.     The first is as a static period, where the period entered is the
  225.     absolute period used in the search. This is the only way to search
  226.     for a combined date/time format. To look for a file created since
  227.     May 10, 1996 at 12 noon, you could use the entry: May 10 96 at
  228.     12:00.
  229.  
  230.     The second is a relative period, where the period entered is set
  231.     against the current system clock time and then applied during the
  232.     search. This is strictly a time OR date format, e.g., 2 seconds or 1
  233.     month. To find users who have been logged in during the last three
  234.     days, you could use the entry: 3 days.
  235.  
  236.     Either way, the format is case-insensitive. For example, you could
  237.     use JAN, Jan, or jan as the abbreviation for the month of January.
  238.     This appendix shows all the BNF time measurements in initial caps
  239.     (e.g., Jan or January, 2 Sec or 2 Seconds, etc.).
  240.  
  241.     Some typical uses of the static format in a Date search field are:
  242.  
  243.     Absolute: 15 1996 (defaults to the current month)
  244.  
  245.         Jan 1 97
  246.         July 4 (defaults to the current year)
  247.  
  248.     Some additional uses of the absolute format in a Time search field
  249.     are:
  250.  
  251.         June 15 at 3 PM (defaults to the current year)
  252.         June 16 at 2AM (defaults to the current year)
  253.         June 17 96 at 15:31
  254.         18 at 9:31:14 AM (defaults to current month AND year)
  255.  
  256.     Some typical uses of the relative format in a Date search field are:
  257.  
  258.         Relative: 1 second
  259.  
  260.         5 Min
  261.         1 day
  262.         2 weeks
  263.         1 Year
  264.  
  265.     The rest of this appendix defines the time formats you can use
  266.     whenever you fill in a date and/or time field.
  267.  
  268.  
  269.  
  270.     USER ACCOUNT MACROS
  271.  
  272.     You can use macros to help initialize the form fields when you
  273.     create a User Account. 
  274.  
  275.     The following types of fields accept macros:
  276.  
  277.     + Login Name
  278.     + Home dir.
  279.     + Password
  280.     + Mail Alias
  281.  
  282.     Format
  283.  
  284.     A macro has the following format:
  285.  
  286.         %<Modifiers><Macro Name>
  287.  
  288.     Modifiers
  289.  
  290.     <Modifiers> are optional (you can define them multiple times). You
  291.     can use the <Modifiers> to specify only specific parts of the field,
  292.     such as the first letter of the field, or to manipulate and convert
  293.     the given input.
  294.  
  295.     A modifier has the following format:
  296.  
  297.  
  298.     [<Converter><Range>]
  299.  
  300.     where <Converter> is one or more of the following characters:
  301.  
  302.         l - Convert the resulting string to lower case
  303.         L - Same as `l'
  304.         u - Convert the resulting string to upper case
  305.         U - Same as `u'
  306.         s - Do not include SPACEs
  307.         S - Same as `s'
  308.         _ - Replace SPACEs with underscores (_)
  309.  
  310.     and the <Range> applies to the complete string in the field (by
  311.     default). Or you can apply a range to a specific word in the input
  312.     string.
  313.  
  314.     Consequently, a <Range> has the following format:
  315.  
  316.         $<word number><Character Range>
  317.  
  318.     where <word number> shows the word's sequence in the string (this is
  319.     optional). The first word would be addressed as $1, the second word
  320.     as $2, and so on. You can also use $0 to address the first word.
  321.  
  322.     <Character Range> is a comma separated list of character ranges in
  323.     the form. If you specify a <word number>, you must first use a comma
  324.     (`,') in the range list.
  325.  
  326.     The character range itself has the following format:
  327.  
  328.         <start char>-<end char>
  329.  
  330.     where <start char> and <end char> are character numbers. You can
  331.     omit one end of the range to signify the "start of string" and "end
  332.     of string" respectively. Ranges which go beyond the end of the
  333.     string are truncated to match the string.
  334.  
  335.     Macro Name
  336.  
  337.     <Macro Name> is one of the following characters:
  338.  
  339.         g - replace with the users' GID
  340.         u - replace with the users' UID
  341.         G - replace with the users' group name
  342.         U - replace with the users' login name (username)
  343.         R - replace with data from the users' Real Name field
  344.         O - replace with date from the users' Office field
  345.         T - replace with date from the users' Telephone field
  346.  
  347.     Examples
  348.  
  349.     These definitions make more sense when they are viewed as examples.
  350.     Assume for the following example, the following data is true:
  351.  
  352.         Real Name: Thomas Kraus
  353.         Login Name: tmk
  354.         UID: 302
  355.  
  356.     You could then define the following macros and see the following
  357.     substitutions.
  358.  
  359.         Field Name   Macro               Value
  360.         -------------------------------------------
  361.         Home Dir     /home/%U           /home/tmk
  362.         Password     %U-%u              tmk-302
  363.         Mail Alias   %[u$1]R_%[u$2]R    THOMAS_KRAUS
  364.         Login Name   %[l$1,1][l$2,-6]   tkraus
  365.  
  366.     Some explanations:
  367.  
  368.     /home/%U Create the directory /home/<login name>
  369.  
  370.     %U-%u Get the User name and add the UID (separated by a dash)
  371.  
  372.     %[u$1]R_%[u$2]R Get the first word of the users' real name and add
  373.     the second word of the user's real name (separated by an
  374.     underscore). Convert both strings to upper case.
  375.  
  376.     %[l$1,1][l$3,-6]R Take the first letter of the users first name and
  377.     the first six letters of the users' last name. Convert both strings
  378.     to lower case.
  379.